Metadata-Version: 2.1
Name: Dowell-secure-github-repository
Version: 0.5.0
Summary: Dowell secure github repository from DoWell
Author: uxlivinglab
License: Apache License 2.0
Description-Content-Type: text/markdown

# Version: 0.5.0

# Description:

This Package seamlessly integrates with Github's webhooks, enabling automatic backups of code repositories. It provides real-time backups triggered by specified events, ensuring data protection. The Package offers customization options, allowing developers to define backup frequency and scope. With robust encryption and disaster recovery mechanisms, the Secure Repository Package ensures the integrity and availability of your code backups.



The Secure Repository Package offers a range of powerful features to enhance code backup:



- Repository Clone: The Package enables easy cloning of repositories, allowing you to create copies of your codebase. This functionality ensures that you have a complete and up-to-date backup of your repositories, ready for immediate use or restoration.

- Webhooks Integration: With seamless integration with Github's webhooks, the Package automatically triggers backups based on specified events. Whether it's a new commit, branch update, or pull request, the Package captures these changes in real-time, ensuring that your backups are always up to date.

- Backup Reports: The Secure Repository Package generates comprehensive backup reports, providing valuable insights into the status and success of each backup operation. These reports include details such as backup timestamps, repository names, and any potential errors encountered during the backup process. These reports serve as a handy reference for tracking backup history and troubleshooting.

- Repository Reports: In addition to backup reports, the Package also generates repository reports, offering an overview of each repository's status and health. These reports provide information such as the number of commits, branches, and contributors, giving you a clear snapshot of your codebase's activity and progress.

# Installation:

- Install the package using pip: 

```python

pip install Dowell-secure-github-repository

```

        

# Usage:

- Import the package and create an instance of the `doWellSecureGithubRepository` class:

    

```python

from doWellSecureGithubRepository import doWellSecureGithubRepository



api = doWellSecureGithubRepository(api_key)

```

    

- Available methods:

    - `clone_repository(repository_url)`: Clones a GitHub repository for backup.

    - `get_backup_reports()`: Retrieves backup reports.

    - `get_repository_reports()`: Retrieves repository reports.

    - `__init__(self, api_key)`

        

        Description: Initializes an instance of the doWellSecureGithubRepository class.

        

        Parameters:

        

        - `api_key` (str): The API key required for authentication with the Secure Repository API.

    - `clone_repository(self, repository_url)`

        

        Description: Clones a GitHub repository by making a POST request to the Secure Repository API.

        

        Parameters:

        

        - `repository_url` (str): The URL of the GitHub repository to clone.

        

        Returns: The response from the API as a JSON object.

        

    - `get_backup_reports(self)`

        

        Description: Retrieves backup reports from the Secure Repository API by making a      GET request.

        

        Returns: The response from the API as a JSON object.

        

    - `get_repository_reports(self)`

        

        Description: Retrieves repository reports from the Secure Repository API by making a GET request.

        

        Returns: The response from the API as a JSON object.

        

# Example:

    

```python

from doWellSecureGithubRepository import doWellSecureGithubRepository



api = doWellSecureGithubRepository(api_key)

api.clone_repository(repository_url)

api.get_backup_reports()

api.get_repository_reports()

```

    

# API Reference:

- `doWellSecureGithubRepository` class:

    - `__init__(api_key)`: Initializes the `doWellSecureGithubRepository` object with the API key.

    - `clone_repository(repository_url)`: Clones a GitHub repository for backup.

    - `get_backup_reports()`: Retrieves backup reports.

    - `get_repository_reports()`: Retrieves repository reports.

# Configuration:

- The package requires a valid API key for authentication.

# Dependencies:

- requests: Required for making HTTP requests.

- json: Required for parsing JSON data.

# Support:

- For detailed API documentation, including endpoint descriptions, request and response examples, and authentication details, please refer to the [API Documentation](https://github.com/DoWellUXLab).

- If you encounter any issues, have questions, or need assistance with the Secure Repository API, please contact our support team.

# License:

- Apache License 2.0
